/*
 * Copyright 2002-2020 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.core.convert.support;

import org.springframework.core.convert.converter.Converter;
import org.springframework.core.convert.converter.ConverterFactory;
import org.springframework.lang.Nullable;
import org.springframework.util.NumberUtils;

/**
 * Converts from a String any JDK-standard Number implementation.
 *
 * <p>Support Number classes including Byte, Short, Integer, Float, Double, Long, BigInteger, BigDecimal. This class
 * delegates to {@link NumberUtils#parseNumber(String, Class)} to perform the conversion.
 *
 * @author Keith Donald
 * @since 3.0
 * @see java.lang.Byte
 * @see java.lang.Short
 * @see java.lang.Integer
 * @see java.lang.Long
 * @see java.math.BigInteger
 * @see java.lang.Float
 * @see java.lang.Double
 * @see java.math.BigDecimal
 * @see NumberUtils
 */

/**
 *
 1.StringToNumberConverterFactory实现了ConverterFactory<String, Number>接口。这意味着这个工厂类专门负责创建从String类型到Number类型（及其子类型）的转换器。
 2.接口ConverterFactory有一个方法getConverter，它需要返回一个具体的Converter实例。在这里，该方法接收一个类型参数Class<T>，其中T是Number的子类型（例如Integer、Double等）。
 3.在getConverter方法中，它返回了一个StringToNumber的实例，这个实例被传递了targetType参数，这个参数表示目标数字类型。
 4.StringToNumber是一个内部私有静态类，它实现了Converter<String, T>接口。这意味着这个类负责将String类型转换为T类型的实例。
 5.StringToNumber类有一个构造函数，它接收一个Class<T>类型的参数，并将其存储在实例变量targetType中。
 6.StringToNumber类实现了convert方法，这是Converter接口要求实现的方法。convert方法接收一个String类型的参数source，并返回一个T类型的实例。
 7.在convert方法中，如果输入字符串为空，则返回null。如果不为空，则使用NumberUtils.parseNumber方法将字符串转换为targetType指定的数字类型。NumberUtils是Apache Commons Lang库中的一个实用类，它提供了多种数字处理的方法。
 */
final class StringToNumberConverterFactory implements ConverterFactory<String, Number> {

	@Override
	public <T extends Number> Converter<String, T> getConverter(Class<T> targetType) {
		return new StringToNumber<>(targetType);
	}


	private static final class StringToNumber<T extends Number> implements Converter<String, T> {

		private final Class<T> targetType;

		public StringToNumber(Class<T> targetType) {
			this.targetType = targetType;
		}

		@Override
		@Nullable
		public T convert(String source) {
			if (source.isEmpty()) {
				return null;
			}
			return NumberUtils.parseNumber(source, this.targetType);
		}
	}

}
